home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / clang / nn.zip / PROBLEMS < prev    next >
Text File  |  1989-12-31  |  11KB  |  297 lines
  1. Here is a collection of some of the problems people have had with
  2. installation and operation of nn in the past.
  3.  
  4.  
  5. RUNNING NN ON 80286
  6. -------------------
  7.  
  8. The system and machine file for a '286 running Microport UNIX V/AT are
  9. s-uport2-2.h and m-i80286.h, but to get it running you probably have
  10. to do the following things as well:
  11.  
  12. - tgetstr.o in libcurses is broken in 2.4.
  13.   Get an old version (e.g. 1.3) and replaced tgetstr.o.
  14.  
  15. - Use the m286 malloc posted recently to comp.sources.misc
  16.  
  17. Thanks to Wietse Z. Venema and Miek Grenier for a lot of work on 
  18. locating and fixing 16/32 bit problems in nn which caused it not to
  19. work on the '286.
  20.  
  21.  
  22. FILE PERMISSIONS
  23. ----------------
  24.  
  25. You should run as root when installing the package & db, because some
  26. directories might be created in places where ordinary users are not
  27. allowed to write, and secondly because it is not allowed to change the
  28. owner of a file (nnmaster) on some systems.
  29.  
  30. This might be the cause of your problems.
  31.  
  32. In general, the permissions and ownership of the various programs
  33. should be set to allow the following access:
  34.  
  35. - To let the nnmaster READ the news directory (no problem since
  36.   /usr/spool/news normally has mode 755),
  37.   
  38. - To let the nnmaster WRITE in the db-directory and files
  39.   
  40. - To let ordinary users programs (i.e. nn) READ the db-directory.
  41.   
  42. For example,
  43.               owner   group   mode
  44.   db-directory & files:    news    news    755
  45.   nnmaster:        news    news    6755 (suid)
  46.   nn etc:        storm    other    755
  47.  
  48.  
  49. EXPIRED ARTICLES STILL SHOW UP ON THE MENUS
  50. -------------------------------------------
  51.  
  52. This common problem is caused by the way the nnmaster "detects" that
  53. expire has been run on a news group: It compares the number of the
  54. first article in the active file with the first article in the data
  55. base.  As long as they are identical, nnmaster believes that expire
  56. has not been run.
  57.  
  58. However, if the first article has an expiration date sometime in the
  59. future it is not removed, although many of the following articles may
  60. very well have been removed.
  61.  
  62. To overcome this problem, you can instruct the nnmaster to recollect
  63. all groups once a week, or after expire has been run.  You do this by
  64. inserting the following command in the crontab to be executed at a
  65. suitable time (with permissions of the owner of nnmaster):
  66.  
  67.     /usr/local/bin/nnadmin I
  68.  
  69.  
  70. ABOUT BLOCKED GROUPS
  71. --------------------
  72.  
  73. A group is blocked while the nnmaster is collecting new articles in
  74. that group.  In a newly initialized database, all groups will be
  75. blocked until the nnmaster has collected them the first time, which
  76. may take an hour or so the first time you run nnmaster -r.
  77.  
  78. This means that there may not be any news to read for a while after
  79. you have just started the nnmaster the first time.
  80.   
  81.   
  82. PROBLEMS SENDING MAIL
  83. ---------------------
  84.  
  85. Some people have experienced problems sending mail.
  86.  
  87. In one case, the recmail program was corrupted.
  88.  
  89. In another case, uux was not silent causing the trace file (in the aux
  90. script) to be non-empty which fooled nn to think that nothing had been
  91. sent (although it did).  If you get failed reply/follow-up messages
  92. look for a line saying something like "uucp job XXXXX" - This is
  93. caused by the environment setting JOBNO=ON.
  94.   
  95. Also notice that some recmail programs may treat a line consisting of
  96. a single period in the first position as end-of-file.
  97.  
  98.  
  99. ACCESSING NEWS REMOTELY  
  100. -------------------------
  101.  
  102. I have received the following problem description which seems to
  103. indicate a network problem.  You can now set the variable
  104.     retry-on-error
  105. to the number of times nn should try to open an article (you may
  106. want to do this in the global init file!):
  107.   
  108.    We are running on a VAXstation 2000, with the news accessed
  109.    remotely, so I get a lot of "can't read" errors.  It seems to
  110.    me these errors should ALWAYS require acknowledgement before
  111.    clearing the message, and should offer the possibility to
  112.    re-try the operation (which usually then works for us).
  113.  
  114. There is a similar option [-y] to nnmaster which can be set to have
  115. the nnmaster perform retries as well.
  116.  
  117.  
  118. TERMINAL I-O PROBLEMS
  119. ---------------------
  120.  
  121. nn does not echo the characters you type except when you are entering
  122. a string, e.g. a file name.  Instead it attempts to make a significant
  123. change to the data displayed on the screen.  On a slow system this may
  124. be seen as a drawback; on fast systems it is an intended feature!
  125.  
  126. If CBREAK is available, nn will use it, but when CBREAK is not avaiable
  127. nn uses raw mode when reading from the keyboard and cooked mode when
  128. printing on the screen (it flips forth and back).  [This behaviour can
  129. be disabled by unsetting the flow-control variable]  This has caused
  130. problems on some systems (e.g. the 3B2) where the tty driver is
  131. located on a dedicated IOprocessor, which for some reason handles
  132. ioctl's "out of band".  I have tried to work around these problems by
  133. outputting \r\n sequences where \n should have been sufficient.
  134.  
  135. nn also intentionally discards type-ahead at certain points, but only
  136. if CBREAK mode is not supported, and the flow-control variable is set.
  137.  
  138. On some systems, TCSETAF also flushes the output queue; you may try to
  139. replace it by TCSETAW followed by TCFLSH.
  140.  
  141. On terminals where the left arrow key sends a backspace (such as
  142. Wyse50), the backspace key will not properly work as the erase key.
  143. To circumvent this problem on these terminals, place the following
  144. line in your init file:
  145.     set erase-key left
  146.  
  147.  
  148. Cnews
  149. ------
  150.  
  151. nn wants articles to contain Lines: headers, but Cnews doesn't
  152. generate these in the default setup.  You may uncomment the
  153. Lines: code in the inews script.
  154.  
  155. As distributed, Cnews does not maintain the 'min' value in the active
  156. file - there is a program named `upact' to do this.  Without it, 
  157. expire on the database will not be performed.  One of the Cnews
  158. patches is said to have changed this, but check it out.
  159.  
  160.  
  161. NNMASTER WILL NOT START OR IS LOOPING
  162. -------------------------------------
  163.  
  164. If no nnmaster is running, and nnmaster refuses to start up, you
  165. should check for the existence of the MPID file in the LIB directory,
  166. If it exists, it should be removed.
  167.  
  168. If nnmaster starts looping, you should check the permissions on the
  169. LIB directory and notice if a GATE file exists which nnmaster is not
  170. allowed to unlink.
  171.  
  172.  
  173. NNMASTER DIES WHEN STARTED FROM A TERMINAL
  174. ------------------------------------------
  175.  
  176. The definition DETATCH_TERMINAL in the s- file you use may not work
  177. (it is a no-op on some systems).  This will cause a hangup signal to
  178. be sent to the master when you logout, and that will terminate the
  179. master.
  180.  
  181.  
  182. WARNINGS DURING COMPILATION
  183. ---------------------------
  184.  
  185. If you get a syntax error when compiling the folder.c file, you
  186. probably have defined HAVE_DIRECTORY in the s- file, but even though
  187. the include file exists, it does not define the DIR type.  Either get
  188. hold of a public domain directory package (look in the gnu
  189. distribution), or just undefine HAVE_DIRECTORY which causes nn to use
  190. (much slower) shell commands for file name completion (and disables
  191. the ?-help for file names).
  192.  
  193. If the linker complains about not finding the function `strcspn'
  194. (whice should be in most standard libraries these days), define the
  195. symbol STRCSPN in the m- file (or config.h) to use the version in
  196. regexp.c.
  197.  
  198.  
  199. FORMATTING THE MANUALS
  200. ----------------------
  201.  
  202. Many versions of the -man package may have problems handling the `@'
  203. characters as hanging tags (.TP).  Fix your man package by
  204. substituting ALL occurrences of the @ character in tmac.an (or perhaps
  205. tmac.an.new) by a BEL (^G) character.
  206.  
  207.  
  208. RESIZING
  209. --------
  210.  
  211. Resizing only works with termcap (on BSD systems)!
  212.  
  213. If resizing occurs while reading an article, the article is repositioned
  214. on the first page of the article.
  215.  
  216.  
  217. NNMASTER AND NN DOES NOT FIND ANY NEWS
  218. --------------------------------------
  219.  
  220. All known occurrences of this problem have been identified and fixed.
  221.  
  222. Be careful about the 'limit' and 'old' variables.  Setting them in the
  223. init file may cause nn to behave strangely (as documented :-)
  224.  
  225.  
  226. THE DATABASE BECOMES CORRUPTED FOR NO APPARENT REASON
  227. -----------------------------------------------------
  228.  
  229. This has been seen on some systems in the past.
  230. Three causes for these problems have been identified:
  231.  
  232. - There was a serious bug in rel. 6.1 which was solved by patch # 5.
  233.   Actually, there were no errors in the database, but nn misinterpreted
  234.   some information, and reported that the database was corrupted.
  235.  
  236. - Some .o files had not been recompiled by make after modifying the
  237.   config.h file (this happened on SunOS 4.0 which seems to forget to
  238.   update file modification times for some files (has anybody seen this
  239.   before?)).
  240.       
  241. - There may still be a bug in the default expire code (when nnmaster
  242.   is invoked WITHOUT the -E option) which causes the master to lose
  243.   either the first or the last article in the group.  Until we have
  244.   this problem sorted out (or determined that there isn't a bug), the
  245.   use of -E on the nnmaster is recommended.
  246.  
  247. - nn release 6.3 patch #4 introduced a new 'misinterpretation' of the
  248.   database.  It is fixed in patch #5. 
  249.   
  250.   
  251. 8 BIT SUPPORT
  252. -------------
  253.  
  254. I am rather embarrassed to admit that a program leaving Denmark in
  255. 1989 does not support 8 bit character sets - however, that is the
  256. plain truth.  Currently, all characters typed on the keyboard are
  257. stripped to 7 bits, and only printable characters in the 7 bit ASCII
  258. character set are (normally) displayed on the screen.  (You can set
  259. 'monitor' to see all the characters in an article).
  260.  
  261. Anyway, ISO 8859/1 support is next on my agenda.
  262.  
  263.  
  264. MAIL RECORDS
  265. ------------
  266.  
  267. There are some things you have to consider in connection with the mail
  268. and news record files:
  269.  
  270.  - When you :mail to yourself, a copy is not saved in the mail-record.
  271.  
  272.  - If the mail/post fails, the message is saved in ~/dead.letter instead
  273.  
  274.  - Since the posting is performed in the background and it may take
  275.    upto a minute to complete posting an article, updating news-record
  276.    will not happen instantly.
  277.         
  278.  - In previous releases the mail header created by nn in the record
  279.    files are not recognized by the digest splitting code in nn, i.e.
  280.    the always appear to contain a single article.  This is fixed in
  281.    release 6.3, but you may have old folders which nn will not be able
  282.    to split (there is no From: line).
  283.  
  284.    
  285. NNTP PROBLEMS
  286. -------------
  287.  
  288. A few problems with the current NNTP support are described in the NNTP
  289. file. 
  290.  
  291.  
  292. OTHER PROBLEMS (you might call them bugs)
  293. -----------------------------------------
  294.  
  295. The 'master flags' set on a group with nnadmin are forgotten if the
  296. database is reinitialized with nnmaster -I.
  297.